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PREFACE 



This manual describes the ISIS-II LINK, LOCATE, and LIB utility programs, as 
well as the OBJHEX and HEXOBJ code conversion programs. These programs 
manipulate 8080 and 8085 object modules. The following references will probably 
aid you in your use of this manual: 



Related Literature 

Intellec Series III Microcomputer Development System Product 

Overview 121575-001 

Intellec Series HI Microcomputer Development System Console 

Operating Instructions 1 2 1 609-00 1 

Intellec Series III Microcomputer Development System 

Programmer's Reference Manual 12161 8-00 1 

Intellec Series III Microcomputer Development System Pocket 

Reference 121610-001 

8080/8085 Assembly Language Programming Manual 980030 1 D 

75/5-7/ 8080/8085 Macro Assembler Operator's Manual 9800292D 

8080/8085 Assembly Language Reference Card 9800438D 

You may also wish to keep the language manual and compiler operating instructions 
handy if you are programming in either PL/M-80 or Fortran-80. 



Notational Conventions 



UPPERCASE Characters shown in uppercase must be entered in the 

order shown. You may enter the characters in uppercase 
or lowercase. 

italics Italics indicate variable information, such as filename or 

address. 

[ ] Brackets indicate optional arguments or parameters. 

•C > One and only one of the enclosed entries must be selected 

unless the field is also surrounded by braces, in which 
case it is optional. 

i y . . . At least one of the enclosed items must be selected unless 

the field is also surrounded by braces, in which case it is 
optional. The items may be used in any order unless 
otherwise noted. 

Ellipses indicate that the preceding argument or 
parameter may be repeated. 



punctuation Punctuation other than ellipses, braces and brackets must 
be entered as shown. For example, the punctuation 
shown in the following command must be entered: 

SUBMIT PLM86(PROGA,SRC, '9 SEPT 81') 

JfiBffllffil5l3 In interactive examples, input lines and user responses are 

printed in white on black to differentiate input lines from 
system output. 
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CHAPTER 1 
INTRODUCTION TO MODULAR 

PROGRAMMING 



The "Tools" of Modular Programming 

Modular programming is fairly straightforward once you have determined module 
inputs and outputs, such as parameters passed between modules, and links to the 
"outside world" of other programs and I/O. Modular programming produces 
clear, efficient programs. However useful modular programming may be, it would 
not help much without the software tools needed to manipulate modules. Three 
module handling programs can fill this need: 

• A linking program which combines separate modules into a single module. 

• A locating program which turns relative memory addresses into absolute 
addresses, so that the program may be loaded for execution or debugging. 

• A library manager which permits you to create and update libraries of program 
modules which you will need in the future. 

ISIS-II fulfills these requirements with the LINK, LOCATE, and LIB programs, 
along with the standard object code format produced by the PLM80 and FORT80 
compilers and the ASM80 assembler. These programs provide full modular pro- 
gramming capacity. 



NOTE 

These 8080/8085 linkage and location features are not applicable to iAPX 
86 and iAPX 88 object code. For information on iAPX 86,88 family object 
module management, see the iAPX86,88 Family Utilities User's Guide for 
8086-Based Development Systems . 



Other absolute object code formats are not compatable with the ISIS-II system so 
two code conversion programs have been provided: 

• The HEXOBJ command translates hexadecimal code to the absolute modules 
format for execution on the ISIS-II system. Hexadecimal format code is pro- 
duced by translators on large systems and by earlier ISIS assemblers. 

• Translation from ISIS-II absolute module format to hexadecimal is performed 
by the OBJHEX program. This command is used to convert files from the 
ISIS-II format to Hexadecimal for PROM loading or execution on another 
system. 

The LINK program combines ISIS-II 8080/8085 object modules in a single file. The 
relative addresses of instructions within the modules are adjusted to correspond to 
their position in the linked module, and references between modules and between 
programs are resolved. 

The relative addresses assigned by LINK to instructions in program modules are 
converted to absolute addresses by the LOCATE program. LOCATE produces 
absolute object modules which can be executed under ISIS-II. 

Modules which will be used again are usually kept in libraries. LIB allows the pro- 
grammer to create libraries, to add or delete modules, and to list available modules. 
Standard mathematical functions, I/O routines, and frequently used program 
segments make up most libraries. 
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The Advantages of Modular Programming 

Most programs are too long or complex to write as a single block. Programming 
becomes much simpler when the code is divided into small functional units. Modular 
programs are usually easier to code, debug, and change than straightline programs, 
and generally run more efficiently, too. The main program and the subroutines can 
be coded separately once the module interfaces have been determined. The modular 
approach to programming is similar to the design of hardware which contains 
numerous circuits. The device or program is logically divided into "black boxes" 
with specific inputs and outputs. The internal structure of each unit need not be 
known to design others. Each routine or circuit is a discrete unit whose inputs and 
outputs are fully defined. 



Efficient Program Development 

Programs can be developed more quickly with the modular approach since the small 
sub-programs are easier to understand, design, and test than large programs. With 
the module inputs and outputs defined, the programmer can supply the needed input 
and verify the correctness of the module by examining the output. The debugged 
modules are separately written and translated to machine-understandable code and 
stored in a library file with the LIB command. When all the needed modules are 
completed and tested, the LINK command will combine them into one program 
module. This module can be assigned absolute memory addresses by LOCATE, and 
the entire program tested. 



Use of Different Source Languages 

One of the greatest advantages of modular programming on the ISIS-II system is 
that individual modules may be programmed in different source languages. 
"Number crunching" routines are best written in FORTRAN because of its 
mathematical capabilities. I/O routines can be coded in PL/M because of the ease 
with which that language handles input and output. Assembly Language is best 
suited for routines which handle any bit manipulation which may be needed. 

The ISIS-II FORT80 and PLM80 compilers and the ASM80 assembler produce the 
same object code format, so a finished program can be built from these segments. 



Multiple Use of Subprograms 

Code written for one program is often useful in others. Modular programming 
allows these sections to be saved for future use. Because the code is relocatable, 
saved modules can be linked to any program which fulfills their input and output 
requirements. With straightline programming, such sections of code are buried 
inside the program and are unavailable. 



Ease of Debugging and Modifying 

It is much easier to track down bugs in modular programs. Once the faulty module is 
identified, fixing the problem is considerably simpler. When a program must be 
modified, modular programming again simplifies the job. You can link new or 
debugged modules to the existing program with confidence that the rest of the pro- 
gram will not be changed. 
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Microprocessor Memory Allocation 

Microprocessor memory in field applications is usually tailored for a specific task, 
with RAM (read/write memory) for variable data and ROM (read-only memory) or 
PROM (programmable ROM) for your program and constant data. Memory can be 
installed in such a way that some memory addresses refer to no actual memory. 

You may not know the addresses of RAM and ROM in your final application during 
early development, while you are still writing and testing your program on the 
Intellec system. The only memory constraints imposed by the development system 
are that your programs do not overwrite ISIS-II resident routines, and that they fit 
within available memory. Intellec system memory is a series of RAM locations from 
0to32, 48, or 64k bytes. 



Intellec Memory Organization 



ISIS-II occupies all memory below 12k (3000H), except for locations 24-63. Those 
memory locations contain the eight interrupts. ISIS-II and the monitor use inter- 
rupts 0, 1, and 2; and interrupts 3 through 7 are available for use by your program. 
Memory locations 24-63 are the only ones below 12k that can be loaded with your 
code. Loading other positions below 12k is not possible, but care must be taken to 
assure that your program does not write to memory locations in this area — it is pro- 
tected from program loads, but not from program output operations. Writing to 
memory positions below 12k will damage ISIS-II and will cause errors when system 
functions are requested. (Resetting the system will restore ISIS-II if your program 
does accidentally write to this area.) 

Starting at 12k is the buffer area, used for input and output buffers of 128 bytes 
each. One buffer is reserved by ISIS-II for console input/output. The minimum area 
allows for three permanent buffers, including the console buffer. If your program 
requires more than these permanent buffers, more will be added and removed as 
necessary. 

Your programs run in the area above the buffers and below the top of memory. 
ISIS-II nonresident routines such as the editor and the command interpreter also run 
in this area. Some nonresident programs of ISIS-II use almost all of the RAM 
between the buffers and 32k. For this reason, the first 32k of memory in an ISIS-II 
system must be RAM. Above 32k, the memory may be any combination of ROM 
and RAM. User programs which remain permanently in memory must be placed 
above 32k so that the ISIS-II programs do not overwrite them. 

The monitor MEMCK routine returns the address of the top of contiguous RAM 
minus the workspace reserved for the monitor. On a 64k system, the monitor itself 
uses 2k of RAM, so the value returned by MEMCK will be equal to the top of 
memory less 2k less 320 bytes. On a 32k system, the monitor is not located in con- 
tiguous RAM, so MEMCK will return the location of the top of memory minus 320 
bytes. These reserved areas are treated in the same way as the ISIS-II reserved 
areas— protected from program loading, but not from program output. 

As your program develops, and as your application hardware becomes available, 
address requirements will become more specific. In the final application, code may 
be in PROM beginning at location and variable data may be in the first block of 
RAM. A program which had a base address of 4000H for compatability with ISIS-II 
and had variable data immediately following the code will need new addresses to fit 
these application requirements. A development system which produced only 
absolute code would require program modification to produce new addresses. With 
ISIS-II's relocatable object code, you need only produce a new absolute module 
with the LOCATE program. LOCATE can assign specific addresses to place code in 
ROM or PROM and variable data in RAM. 
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Program Segments and Memory Requirements 

The locate program allows the user to specify the location of segment to areas of 
memory because of the way in which the language translators divide modules into 
segments. The segments are: 

• Code — This segment contains the machine instructions and constant data which 
is not modified during program execution. It is generally placed in ROM or 
PROM. 

• Data — The data segment, which must be in RAM, contains variable data and 
storage for input and output buffers. 

• Stack — The program stack, which must also be in RAM, contains the data and 
return address needed when a program enters and returns from a subroutine or 
function. 

• Memory — This segment is the remaining system RAM memory which is not 
required for code, data, or the stack. Its size is determined by LOCATE with the 
monitor MEMCK routine when the program is located for execution on ISIS-II. 

• Common segments — FORT80 requires RAM memory for COMMON and 
BLANK COMMON areas. These areas are needed by FORT80 for storage of 
variables which are used in more than one block of code. 

• Absolute information — Relocatable modules can contain absolute information 
in addition to these relocatable segments. The ASEG statement in Assembly 
Language causes the instructions following it until the next CSEG or DSEG 
statement to have absolute addresses. 

LINK can accept absolute modules produced by LOCATE. The linked module 
produced will be relocatable except for that section. PL/M-80 variables 
declared with the AT attribute have absolute references when compiled. 

LINK gives segments a relative start address of zero. Subsequent instructions and 
data are given increasing relative addresses. The addresses are "relative" to the 
beginning of the segment. With LOCATE, a base address (the absolute memory 
location which the start of a segment will occupy) can be specified for any segment 
when a relative object module is located. LOCATE adds this base address to each 
relative address, forming absolute addresses. References between relative memory 
addresses are adjusted appropriately. When all relative addresses have been replaced 
with absolute addresses, the module is an absolute object module. 

Relocation and Linkage 

The ISIS-II resident compilers, FORT80 and PLM80, and the assembler, ASM80, 
provide LINK and LOCATE with various types of information in the relocatable 
object modules they create. This information consists of: 

Relative addresses of instructions and data in the module. 

A list of addresses, contained in the address fields of instructions or in data, 
which refer to locations within the same segment. These addresses are called 
intra-segment references. 

A list of addresses which refer to locations in the same module, but in a 
different segment. These are called inter-segment references. 

A list of addresses which refer to locations in other modules. These are termed 
external references. 

A list of the public and/or external symbols in the module. These symbols allow 
LINK to satisfy external references. 

You must understand public and external symbols and external references to suc- 
cessfully use LINK and LOCATE. Other topics will be discussed in tliis section to 
give a complete picture of the mechanics of relocation and linkage. 



1-4 



MCS-80/85 Utilities 



Introduction to Modular Programming 



Relative Addressing 

When a source program is compiled by PLM80 or FORT80 or assembled by 
ASM80, relative addresses are assigned to instructions and information in the code 
and data segments. The addresses are assigned by a location counter which is set to 
zero at the start of each segment, and is incremented by the byte length of each 
instruction or data element in the segment. 

LINK combines several modules to form one object module by combining all 
segments of a kind into one segment. All code segments are joined in one code seg- 
ment; all data segments are combined into one data segment, and so on. The relative 
addresses in the first of each type of segment are unchanged. The addresses of the 
segments which are appended to that segment are equal to the length of the first seg- 
ment plus their original relative address. 
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Figure 1 -1 . Computing Relative Addresses 



LOCATE produces an absolute module from a relocatable one by adding an 
absolute base address to each address in every segment. You may select the base 
address for each segment, but they can be left for LOCATE to assign. The order of 
segments in the absolute module can be assigned by the user or may be left to be set 
by LOCATE. 

Intra- and Inter-Segment References 

Relative addresses in data or in the address fields of instructions which make 
reference to other locations must always match the addresses of the referents. If the 
address refers to a location within the same segment, it is an intra-segment reference. 
Instructions which jump back to the beginning of a loop are typical intra-segment 
references. References to a location outside the current segment but within the same 
module are called inter-segment references. A statement in the code segment which 
refers to a location in the data segment is an example of an inter-segment reference. 

LINK updates intra-segment references with the new addresses of the referents once 
they have been assigned. LOCATE converts these references to absolute addresses 
by adding the base address of the segment in which they appear to them. 
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Inter-segment references are processed similarly. The new relative addresses of the 
referents are substituted for the original ones, just as above, but LOCATE adds the 
base address of the segment which contains the referent to the address field of the 
reference, rather than the base of the segment containing the reference. 



External References and Public Symbols 

The remaining type of references are those which refer to locations not within the 
same module. These references differ from those above in that the translator knows 
nothing about the referent. In order for the translator to permit a reference to an 
external location, you must declare the referent as an external symbol. The 
translator will then know that the referent is defined in some other module. The 
referent is an external symbol, and the statement which uses it is an external 
reference. 



Modules containing external references are said to be "unsatisfied" modules. LINK 
searches through all of the modules it is to connect for matching public symbols and 
external references. A public symbol is a variable or a label which is declared to be 
public in the source program. The public declaration is placed in the object code to 
be used by LINK. 



When LINK matches an external reference to a public symbol, the address of the 
public symbol is placed in the address field of the external reference. The address 
may be absolute or relative. Since the modules are linked into one module, and the 
external reference is satisfied, the external declaration is no longer necessary. LINK 
removes external symbols, but not public symbols. The public symbols remain to 
satisfy any modules added in the future which need them. In the linked object 
module, the reference is now an intra- or inter-segment reference. LINK issues a 
warning for each unsatisfied external reference. This is not necessarily an error, so 
LINK continues processing until every possible external reference has been satisfied. 
The unsatisfied module must again be linked to satisfy the remaining external 
references. If you declare an external symbol but never make an external reference 
to that symbol, LINK will give a warning even though no unsatisfied reference 
exists. 



When all external references have been matched to public symbols, a module is 
"satisfied." If LOCATE finds an external reference in an object module which it is 
processing, it issues a warning, but continues to produce the absolute module. This 
allows execution of the program for debugging up to but not including the 
unsatisfied reference. If the reference is executed, the result is unpredictable. 



Keeping Track of Finished Files 

You should have some way of keeping track of the status of object modules. One 
way is saving the LINK and LOCATE memory maps. Another is using extensions 
on the filenames which reflect the file's status. Use caution with the extension. 
.TMP, as many ISIS-II routines use temporary files with this extension. They will 
delete your file if it has the same name and extension as the temporary files they 
create. 
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Libraries 

Libraries of program modules make the job of building programs even simpler. The 
LIB library manager program permits you to create and alter libraries of object 
modules. LIB creates a directory of modules in each library to keep track of the 
modules it contains. It will give you a list of all the modules in a library, and will list 
the public symbols in each module if you wish. LINK uses the libraries in the follow- 
ing manner. Once all the external references have been satisfied by public symbols 
within the modules to be joined, LINK searches the libraries which you have 
specified in the invocation line for public symbols to match any remaining 
unsatisfied external symbols. It then copies the object code of the library module 
containing the public symbol into the linked object module. Only the modules which 
are required to satisfy external references are copied. The process is repeated until all 
possible matches have been made. 
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Introduction 

The ISIS-II LINK program combines a number of object modules specified in an 
input list into a single object module in an output file. The input files may be 
relocatable modules produced by any of the language translators available for use 
with ISIS-II. They may be relocatable files which have already been linked one or 
more times. LINK can even accept absolute files as input. Files which have already 
been linked and located can be run on ISIS-II. Any file in an ISIS-II object module 
format can be processed by LINK. 



Libraries as LINK Input Files 

When libraries of object modules are among the input files, LINK searches them for 
symbols which resolve external references in other input modules. The only library 
modules which are included in the output module are those which satisfy external 
references in other modules. If any unsatisfied references remain after the library 
search is complete, a warning is placed on the LINK map. (The LINK map describes 
the structure of the output module and includes other diagnostic information. The 
map is described in detail on pages 2-4 and 2-5 .) 

As stated in Chapter 1, this warning is not necessarily an indication of an error, as 
during the intermediate steps of program development and debugging, such situa- 
tions are not uncommon. If you place breakpoints in your program before the exter- 
nal references during these development stages, you can execute the program up to 
the breakpoints. If any external reference is left unsatisfied, and the program 
executes through it, the results cannot be predicted. 



Program Segments in the LINK Process 

As LINK combines the modules, it adjusts the relative addresses of the instructions 
and data elements in them. To do this, the modules are separated into the segments 
which make them up. Segments of each type (CODE, DATA, STACK, and 
MEMORY) are appended to one another; all data segments are joined into one data 
segment, all code segments are combined, and so on. The relative address of each 
instruction or data element is adjusted to be relative to the beginning of the new 
longer segment. Finally, the new segments are rejoined to form the object module. 

The order of the modules in the output file is determined by the order of the input 
list. Thus, the file which is specified first in the list will have the lowest relative 
addresses in each segment. The second module listed will begin at the first available 
address after the first module. Again, if a library file is a member of the input list, 
then it must be specified after the module which refers to it. 

For example, the following LINK command is given: 



Module A contains code, data, and stack segments, and a reference satisfied by a 
module in the library OBJECT.LIB. Module B contains code and data only. The 
resulting object module C has the following structure: 
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Figure 2-1 . Segment Type Combination with LINK 
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The exception to this rule is absolute information. LINK does not change absolute 
addresses. When LINK-assigned addresses conflict with absolute addresses, a 
message is placed on the LINK map to indicate this. This message is not necessarily 
an error indication. You may wish to overlap relocatable and absolute addresses. 

If module B had contained a reference to OBJECT. LIB, then the invocation would 
have read: 



LINK A, B, OBJECT. LIB TO C<cr> 



Relocation Types 

All program segments have one of the following relocation types: 

• Absolute, or non-relocatable (A) segments have fixed base addresses and must 
be placed at that address. 

• Byte relocatable (B) segments are placed at the next available byte. 

• Page relocatable (P) segments are located at the first available byte which lies on 
a page boundary (a location with an address evenly divisible by 100H, or 256). 
Such addresses end with -00H. 

• Inpage relocatable (I) segments are located at the first available byte such that 
the segment does not cross a page boundary. Inpage relocatable segments must 
be less than or equal to 100H bytes in length. 

When LINK combines segments with different relocation types, it does so using the 
following rules: 

• Byte relocatable segments follow the preceding segment at the next byte. The 
output segment is byte relocatable only if all input segments are byte 
relocatable. Otherwise, it is page relocatable. 

• Page relocatable segments follow the preceding segment at the first free page 
boundary. The memory locations from the end of the last segment to the page 
boundary are unused. This space is called a gap and will appear on the memory 
map. The output segment is page relocatable. 
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• Inpage relocatable segments are located either immediately after the preceding 
segment (if there is enough room between the end of the last segment and the 
next page boundary) or at the top of the next page. This is because inpage 
relocatable segments cannot cross page boundaries. LINK will change an inpage 
relocatable segment to page relocatability if it is longer than 100H or 256 bytes. 

The output segment will be inpage relocatable only if both of the following con- 
ditions are met. The segment must consist of all inpage relocatable segments, 
and it must be 256 bytes in length or less. If either of these conditions are not 
met, the output segment is page relocatable. 

The memory that is left unused by LINK as it preserves the relocation type of the 
segments is marked on the LINK map. Gaps will be denoted by the entry "*GAP*" 
in the segment name column. 

LINK Invocation 

The LINK program is invoked by 

-LINK inputlist TO outputfile [controls] <cr> 

where inputlist is either 

filename[(.modname ,...)],... 
or 

PUBLICS (filename[(modname ,...)], ... ) 

In the first input list, filename is an ISIS-II file containing object modules. If 
filename is a library of object modules, you have the option to specify which of its 
modules are to be linked into the object file. If modnames are specified, then only 
those modules will be linked in. If the modules are not specified, then LINK will 
search the library for modules which satisfy external references in other modules. 
You may specify as many filenames and modnames as you wish. 

Remember— libraries must be listed after the modules for which they satisfy external 
references. 

In the second input list, only the absolute public declarations from the specified files 
are included. The external references in other modules are satisfied by these declara- 
tions, but the object file produced does not contain the code of the specified files. 
This permits linking without combining for program overlays. (See Chapter 4.) The 
rules for inclusion of library modules are the same. 

The outputfile will contain the object module produced by LINK. The outputfile 
must not be the same as any entry in the inputlist. 

The controls are any of the following: 

MAP 

NAME (modulename) 

PRINT (filename) 

If the invocation is longer then one line on your terminal (or more than 122 
characters), you can continue it on the next line by placing an ampersand (&) as the 
last non-blank character before the <cr> at the end of the line. You may continue in 
this way for as many lines as are necessary to complete the invocation. LINK will 
echo a double asterisk (**) to indicate the continuation. 
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For example: 



** 
** 



LINK : F1 : F I R S 
(THIRD. LIB(M0DA,M0DB) ) 
OUTPUT. LNK P R I NT ( : F1 :0 



The ampersand must not appear within a filename or keyword, but can be placed 
between a keyword and the parenthesis which surrounds its associated parameter list 
as above, between PUBLICS and its list. 

CAUTION 1 

LINK uses a temporary file named LINK.TMP on the disk which is to con- 
tain the output module. If you have a file with that same name on the disk, 
LINK will destroy it. 

Appendix D describes error messages produced by LINK. 



MAP 



Syntax: MAP 

Default: No LINK map is produced. 

Definition: MAP requests that a LINK map be produced. The map is sent to 

the :CO: if no file has been specified with the PRINT(filename) 
control. 

The LINK map includes the following information: 

LINK sign-on message 

Invocation line, exactly as entered (unless map is output to 
:CO:) 

The length of the relocatable segments in the output module 

The addresses of the absolute information in the output 
module 

The names of all of the input modules included in the object 
module 

Any non-fatal error messages or warnings 
The example which follows includes all of this information. 



ISIS-II OBJECT LINKER Vx.y INVOKED BY: 

-LINK ZANA.DOO.KUBLA.KON^rFI :ORSON .WLZ (TINSTAAFL ) ,& 
••PUBLICS(DEVERE.AUX) TO ROSE. BUD NAME(CITIZEN§KANE)& 
••MAP PRINT(TREZUR.MAP) 

TINSTAAFL - MODULE NOT FOUND IN LIBRARY 

LINK MAP OF MODULE CITIZEN§KANE 
WRITTEN TO FILE :F0:ROSE.BUD 

Figure 2.2 LINK Map 
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SEGMENT INFORMATION: 

START STOP LENGTH REL NAME 







2345H 


B 


CODE 




10BCH 


10EEH 


33H 




CODE 


*GAP« 


22FEH 


22FFH 


2H 




CODE 


*GAP* 






107H 


B 


DATA 








OH 


B 


MEMORY 




OH 


2H 


3H 


A 


ABSOLUTE 




40H 


711H 


6D2H 


A 


ABSOLUTE 




700H 


7FFH 


1O0H 


A 


ABSOLUTE 


*0VER 



INPUT MODULES INCLUDED: 
:FO:ZANA.DOO 
:FO:KUBLA.KON(ALPH) 
:FO:DEVERE.AUX(LIBMOD) (PUBLICS) 

UNRESOLVED EXTERNAL NAMES: 

TWILIGHT-REFERENCED IN : FO : KUBLA .KON ( ALPH ) 

<Other errors, if any, would appear here.) 



Figure 2-2. LINK Map (Cont'd.) 



The entries in the REL column indicate the relocation type of 
each segment. They are encoded as follows: 

A Absolute or non-relocatable. Such segments must appear at 
the exact address which is specified in the START column. 

B Byte-relocatable. Segments with this relocation type can be 
placed anywhere in memory which does not cause a conflict. 
There must be enough room to contain the entire segment 
without any overwriting of other segments. 

P Page-relocatable. These segments must be placed at a page 
boundary in memory. A page boundary has an address 
which is divisible by 256. 8080 addresses are 16 bits long, 
and the addresses are contained in two bytes, called the 
high- and low-order bytes. The high-order byte for all 
addresses within a page is the same. Thus, the beginning of 
page-relocatable segments may be accessed by specifying 
only the high-order byte, and setting the low-order byte to 
zero. Once within the segment, other addresses in the seg- 
ment are accessed by the usual combination of high- and 
low-order bytes. 

I Segments of this type must be 256 bytes or less in length. 
This is because such segments contain code which only 
changes the low-order byte of the address. Such a segment 
cannot cross a page boundary, because the code within can- 
not make reference to an address with a different high-order 
address byte. 
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NAME 



Syntax: 
Default: 
Definition: 



Example: 



HAME{modulename) 

outfile name without extension 

The NAME control allows you to select a name for the output 
module which is more descriptive than the six-letter file name. 
The name can be from 1 to 31 characters long, with the follow- 
ing format: 

letter [letter \ dig it \ a \?]... 

Where letter is A through Z, digit is through 9. The commer- 
cial at sign and the question mark may appear anywhere after 
the first character, and are generally used to separate words 
when there are more than one. 

If NAME(modufename) is not specified, then the six-character 
name (without the three-letter extension) of the output file will 
be used. 

(See previous example.) 



PRINT 



Syntax: PR\HT{filename) 

Default: The LINK map, if the MAP control (Page 2-4) is specified, is 

output to :CO:. 

Definition: PRlNT(filename) directs the placement of the LINK map. The 

filename is any ISIS filename — but not one which already exists 
unless you don't care if that file's contents are destroyed and the 
LINK map put in their place. 

Example: In the MAP control example, the LINK map is directed to the 

file :FO:TREZUR.MAP. 
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LOCATE COMMAND 



Introduction 

The LOCATE program converts relocatable input files into absolute output files 
ready for execution on the ISIS-II system. With LOCATE, you have complete con- 
trol over the absolute object module: 

• You may allow LOCATE to determine the order of segments in the output file. 

• You may specify the order of all of the segments. 

• You may specify the order of some of the segments, and allow LOCATE to 
select the rest. 

• You may let LOCATE determine the location of each segment in memory. 

• You may specify the location of any or all of the segments. 

Remember — LOCATE will determine the order and location of all of the segments 
which you do not specify. 

If you specify memory locations incorrectly — by forcing in-page relocatable 
segments across page boundaries, or by causing segments to overlap — then 
LOCATE will issue an error message, but will continue processing the input file. 
The LOCATE program does this because some seeming errors — especially overlap- 
ping segments — are intentional. 

Invoking the LOCATE Program 

The LOCATE program is called by 

LOCATE inputfile [T outputfile] [controls] 
where 

inputfile is an ISIS-II file containing relocatable object code, outputfile is the 
name of the file to contain the absolute object code. 

If TO outputfile is omitted, then LOCATE sends the output to a file with the 
same filename as the inputfile, but with no extension. 



CAUTION! 



If you have a file with the same name as the appropriate output file, 
then it will be destroyed. If outputfile is not specified, then the 
inputfile must have an extension to prevent its destruction. 

The controls are any of the following: 

COLUMNS (number) START (address) 

LINES CODE (address) 

MAP DATA (address) 

N A M E ( output mod name ) MEMORY (address ) 

PRINT (We) STICK (address) 

PUBLICS STACKSIZE(/engf/7) 

PURGE / common I ( address ) 

SYMBOLS 1 1 (address) 

ORDER (segment sequence ) 

RESTARTO 
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Locating with the Specific Address Controls 

You can also change the order of the segments by specifying the base addresses of 
the individual segments. As with the ORDER control, not all segments need to be 
specified. When the address controls are used, the following method is used to deter- 
mine the location of the segments: 

• Segments are located according to the ORDER control (if it is in effect) and the 
default. 

• The starting address of a segment is either the first available byte or page 
boundary (according to relocation type), or the address specified in the segment 
address controls. Gaps will be generated when the relocation type requires it and 
when the next segment's specified address causes it. 

Remember that LOCATE will change the specified base address of a segment if the 
given address violates the segment's relocation type, and in-page relocatable 
segments will be changed to page relocatable if the segment is longer than 256 bytes. 
In either case, an error message is generated. 

This set of controls 



ORDER (DATA, STACK) CODE(6000H) 



will produce the following sequence of segments: 

DATA (located 680H bytes above ISIS-II) 
STACK (located according to its relocation type after DATA) 
CODE (beginning at 6000H) 

/commons/ (if any, immediately after CODE, according to relocation type) 
MEMORY (immediately after /commons/, if any, otherwise, immediately after 
CODE) 

There will be a gap between the end of the STACK segment and the beginning of the 
CODE segment. 

Special LOCATE Considerations 
When Using the Segment Location Controls 

If you intend to specify only some of the segments, and want LOCATE to take care 
of the rest, it is best to use the ORDER control to modify the default sequence so 
that there is: 

1 . Enough space in memory for all of the segments 

2. No chance of conflicts for the same memory space. 

If you do not design the memory allocation carefully, you run the risk of conflicts. 
Just to be safe, always use the MAP control when specifying segment locations. Use 
it to verify the correctness of your memory allocation. Conflicts do not stop 
LOCATE, for reasons explained earlier. 

When you specify FORTRAN common segment addresses using the /commons/ 
and // controls, you should also specify the memory segment address. The memory 
segment must be above the top of the highest of these segments. Since LOCATE 
handles common segments in an arbitrary order, you will not know which common 
segment will be located last. If the last common segment handled by locate is in low 
memory, and LOCATE locates the memory segment by default, it will be placed 
immediately after this common segment and it will overwrite the segments which 
follow. 
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Allocating I/O Buffer Space 

Care must be taken to assure that you leave enough space for the buffers needed by 
ISIS-II for I/O. The maximum space required for buffers must be determined 
before deciding the base address of your program. The number of buffers varies 
dynamically, so the largest buffer area required is one large enough to handle the 
greatest number of buffers open at any instant. If you attempt to set the base 
address of your program (the lowest address in memory which your program 
occupies) below 3180H, an error message will be generated. The maximum number 
of buffers is 19. 

Your program base address can be calculated with either of the following formulas: 

12288 + (128 *N) (N in decimal) 
or 

3000H + (80H * N) (N in hexadecimal) 

where N equals the greatest number of buffers required at any time during your pro- 
gram execution. 

Use the following rules to calculate N: 

• Each open disk file requires two buffers as long as it is open. 

• An open line-edited file including :CI: requires one buffer until the file is closed. 
For a disk file, this buffer is in addition to the two already required by rule 1 . 

• Any system call that accesses a disk directory (LOAD, DELETE, RENAME, 
ATTRIB, or CONSOL when it specifies a disk file) requires two buffers during 
the duration of the call. The buffers are freed upon return to the calling 
program. 

• When the CONSOL system call assigns the console input or output device to a 
disk file, three buffers are required for the console input file and two are 
required for the output file. The buffers are freed upon return to the calling 
program. 

• When the CONSOL system call assigns the console input or output device to a 
disk file, three buffers are required for the console input file and two are 
required for the output file. The buffers are allocated until an end-of-file is 
encountered. 

EXAMPLE: Suppose a program does not contain system calls, does not 
assign the console to a disk file, and is not called by a command 
in another disk file. Such a program needs a minimum of three 
buffers. If the program opens a disk file, then it will need five 
buffers. 

To calculate this program's base address, use either formula: 

12,288 + (128 * 5) =12,928 
or 

3000H + (80H * 5) = 3480H 

Now suppose this same program has been called from a SUB- 
MIT file, where the console output is also a disk file. This adds 
two buffers for the disk output file and two for the program call 
from the SUBMIT file: 

12,288 + (128* 9) =14, 340 
or 

3000H + (80H * 9) = 3408H 
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If you wish your program to be independent of the type of device which is used for 
data transfers and independent of how it is called (from the console or from a sub- 
mit file), you should allow for the maximum number of buffers it might need. This 
means that for any open file you should allow two buffers whether or not it is a disk 
file. You should also allocate five buffers for the console input and output files, 
whether or not it is a disk file. You should also allocate five buffers for the console 
input and output files, whether or not they are disk files. 



Multiple-Line Invocation 



LOCATE allows you to continue the invocation on more than one line if required. If 
the invocation is longer than one line on your terminal (up to a maximum of 122 
characters), then you can continue on the next line by placing an ampersand (&) as 
the last non-blank character before the <cr>. LOCATE responds with a double 
asterisk, indicating that it is ready for the continuation. The rules for the placement 
of the ampersand are the same as for LINK — between words, and between controls 
and associated parameters, but never inside any word. For example: 



CAUTION) 

*********** 



LOCATE uses a temporary file named LOCATE. TMP on the same disk as 
the output file. If you have a file by that name, LOCATE will overwrite it. 

Appendix E, LOCATE Error Messages, lists error messages and warnings. 

The control definitions follow. 



COLUMNS 



SYNTAX: COLUMNS(num^r) 

where number is 1 ,2,or 3 . 

DEFAULT: COLUMNS(I) 

DEFINITION: COLUMNS determines whether the symbol table in the list file 
is to be printed in 1,2, or 3 columns. 

EXAMPLE: The control wmmwilll will produce the following symbol 

table: 
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SYMBOL TABLE OF MODULE BATTLE 
READ FROM FILE BATTLE. SHP 
WRITTEN TO FILE BOTTLE 



VALUE 


TYPE 


SYMBOL 




MOD 


SINK 


3011H 


PUB 


FIRE 


3015H 


SYM 


SIO 


3027H 


SYM 


SI1 


3040H 


SYM 


TIGER 


3062H 


PUB 


TANK 


3102H 


PUB 


BIRD 


3230H 


SYM 


DRONE 


3340H 


LIN 


272 



Figure 3-1 . LOCATE Symbol Table 



NOTE: 



The COLUMNS control is ignored unless SYMBOLS, 
PUBLICS, or LINES is specified. 



LINES 



SYNTAX: LINES 

DEFAU LT: The line numbers are not listed in the symbol table. 

DEFINITION: The LINES control requests that all line numbers and module 
names be entered in the list file as the symbol table. The VALUE 
column in the table is blank for module names. The TYPE col- 
umn displays LIN for line numbers, and MOD for module 
names. 

EXAMPLE: On the symbol table above, the symbols SINK and 272 are a 

module name and a line number placed in the table by the 
LINES control. 

NOTE: The LINES control is not the only control on the contents of the 

symbol table. The SYMBOLS control places input module 
names and local symbols in the table. 

Although the SYMBOLS and LINES controls both place 
module names into the table, LOCATE only includes them 
once. The PUBLICS control includes public symbols on the 
table. 
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MAP 



SYNTAX: MAP 

DEFAULT: A memory map is not produced. 

DEFINITION: The MAP control enables the listing of a memory map on the list 
device or file. The map lists the actual start address of the 
module as well as the start and stop addresses of each individual 
segment, the length of each segment, and the relocation type of 
the segment. These relocation types are from the input file, not 
the output file, as the segments are no longer relocatable. The 
relocation types are the same as for LINK. See page 2-2 for an 
explanation of relocation types. 

When two segments overlap, a warning (*OVERLAP*) is 
issued. LOCATE does not stop processing when an overlap is 
discovered, as they are often intentional. The three-byte overlap 
in the following example is an intentional overlap. The three 
absolute bytes are intended to fit into the relocated data 
segment. 



MEMORY MAP OF MODULE VOICE 
READ FROM FILE : F1 : VOICE .SYN 
WRITTEN TO FILE :F1: VOICE. 
MODULE START ADDRESS AT 3000H 



START 


STOP 


LENGTH 


0008H 


OOOAH 


3H 


3000H 


3*»3FH 


440H 


3440H 


472EH 


12EFH 


3630H 


3632H 


3H 


472FH 


475FH 


31H 


4760H 


F6BFH 


AF60H 



REL 



NAME 



A 


ABSOLUTE 




B 


CODE 




B 


DATA 




A 


ABSOLUTE 


•OVERLAP* 


B 


STACK 




B 


MEMORY 





Figure 3-2. LOCATE Memory Map 



NOTE 

The length given on the map for the MEMORY segment 
is equal to the length of the available memory on the 
host Intellec system. It has no relation to the actual 
amount of memory available in the device for which the 
program is destined. You must be certain that there is 
sufficient memory available in the target device. 
LOCATE has no way of knowing how much memory it 
has. 
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SYNTAX: 

DEFAULT: 
DEFINITION: 



NAME 



N AME{output module name) 



EXAMPLE: 



where output module name will contain the absolute object 
module. 

The module is given the name of the input module. 

This control allows you to assign a descriptive name to the 
object module produced by LOCATE. This name may be from 1 
to 31 characters in length, and must follow the format: 

letter [letter \ digit \ a |?] ... 

where letter is A through Z, digit is through 9, and 3 and ? 
may appear anywhere after the first letter. These two characters 
are generally used to separate words in the name. 



NAME (VOICEaSYNTHESIScDSYSTEM) 



SYNTAX: 

DEFAULT: 
DEFINITION: 

EXAMPLE: 



PRINT 



PR\h\T{fiIename) 



where filename is the ISIS-II file which is to receive all the mat- 
ter directed to the list device. 

If PRYNT(filename) is omitted, then the listing file is :CO:. 

The PRINT control specifies the list file for the ancillary output 
which is not part of the object module. The memory map, sym- 
bol table and error messages are produced for your use in debug- 
ging the program. 



PRINT CTREZUR .MAP) 



SYNTAX: 
DEFAULT: 

DEFINITION: 
NOTE: 



PUBLICS 



PUBLICS 



The printing of the symbol table is supressed, or the public 
symbols are not included if it is printed by another control. 

The PUBLICS control causes the public symbols in the input 
module to be included in the symbol table. If no other symbols 
have been requested, then the PUBLICS control causes the 
generation of the table. 

This control, the SYMBOLS control and the LINES control all 
determine the printing or non-printing of the symbol table and 
its contents. 
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PURGE 



SYNTAX: PURGE 

DEFAU LT: Symbols are left in the absolute module. 

DEFINITION: When the PURGE control is used, all of the public symbols, 
local symbols, module names, and line numbers are removed 
from the object module. This is done to make the module 
smaller and to help it load more rapidly. The symbols should be 
left in until the module is completely debugged as the line 
numbers, local symbols, and module names aid this process. If 
the module is to be linked with another module, then the public 
symbols will be necessary, too. PURGE should only be used on 
completely debugged programs. 



SYMBOLS 



SYNTAX: SYMBOLS 

DEFAULT: The Symbol table is not printed, or the local symbols and 

module names are not included. 

DEFINITION: This is the third of the symbol table controls. Like the LINES 
control, this one causes the module names to be included in the 
table, but includes local symbols instead of line numbers. 



START 



SYNTAX: ST ART (address) 

where address is the address of the first instruction in the code 
segment of your program. As with all of the following controls, 
the value of address may be given in any of these bases: 



Decimal: 



Hexadecimal: 



Octal: 



Binary: 



START(IOOOD) or START(IOOO) Note— a 
value with no base indicated is assumed to be 
decimal. 

START(2FFFH) Note— the address must start 
with a digit. If the value is, for example C40F, 
then the control must read START(0C40FH). 

START(27770) or START(2777Q) Note— the 
use of the letter "O" can lead to confusion, as 
it looks like the numeral "0". For this reason, 
the letter **Q" may be used to indicate an octal 
value. 

START(1 1010100101 B) 
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DEFAULT: The start address is taken from the input module. 

DEFINITION: START permits you to specify the exact starting address of your 
program. You can align the code segment with the ROM in your 
final application by specifying the address of the first ROM 
location. This lets you load the program into the correct memory 
area without having to change the object code. 

The reason that device memory addresses usually do not match 
those from the Intellec system on which you developed the pro- 
gram is that Intellec addresses for user-written programs begin 
at location 3000H to leave room for the ISIS-II resident 
routines. Application systems generally do not have such 
restrictions. 

START can also be used to create room for user-written resident 
routines on the Intellec system. Suppose you have such routines 
and that they occupy 1000H bytes of Intellec memory. These 
routines can reside in the 1000H bytes above the ISIS-II 
routines. If so, then other programs will have to begin at address 
4000H or higher so as not to over-write your resident programs. 
Specifying the START(4000H) control will locate other pro- 
grams accordingly. 



STARTCO 



The program now begins at memory location 00F6H. Note that 
this address is incompatible with ISIS-II. 



RESTARTO 



SYNTAX: 

DEFAULT: 

DEFINITION: 



NOTE: 



RESTARTO 

Locations 0, 1, and 2 are left unchanged in the absolute module. 

RESTARTO places a jump instruction in the first three locations 
of the absolute module. The address field (the target of the 
jump) is the start address of your program. The start address is 
taken from the START control, if that control is in effect, or it 
is determined by the start address in the input module. When the 
CPU receives a RESTART signal, the program counter is set to 
0, .and the jump command is executed. The jump restarts your 
program. Use RESTARTO when you are ready to test the pro- 
gram on your system, whether standalone or with the in-circuit 
emulator. 

RESTARTO is ignored if the module is not a main module. 
RESTARTO is not compatable with ISIS-II, which does not 
allow user code to be loaded into these locations . 
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SYNTAX: 



STACKSIZE 



STACKSIZE(ya/ue) 

where value is the desired length (in bytes) of the stack segment. 



DEFAULT: The stacksize is obtained from the input module. 

DEFINITION: STACKSIZE allows you to allocate a specific space for the stack 
segment of your program. The ISIS-II stacksize calculation 
allows for extra information which your final application will 
not need. By specifying the exact stacksize to fit your needs, you 
make your program smaller and more efficient. 



STACKSIZEC33) 



NOTE: When debugging your program on an Intellec system, 12 

additional bytes are required. If the STACKSIZE control is not 
specified, then LOCATE adds these bytes to the stack length 
obtained from the input file. 



ORDER 



SYNTAX: ORDER(segment list) 

where segment list is a list of the segments which you wish to 
place first, second, third, etc, above the top of ISIS-II. 

DEFAULT: See page 3-2, "How LOCATE Locates Segments." 

DEFINITION: This control permits you to select the order of the segments in 
the absolute module. Those segments not mentioned in the seg- 
ment list are located by the default as described on page 3-3. 



ORDERCSTACK, DATA , /AHAB/) 



CODE 



SYNTAX: 

DEFAULT: 
DEFINITION: 

EXAMPLE: 



CODE(address) 

where address is the desired base address of the code segment. 

See page 3-2, "How LOCATE Locates Segments." 

The CODE(address) control locates the beginning of the code 
segment at the specified address. 



3-12 



MCS-80/85 Utilities 



Locate Command 



DATA 



SYNTAX: 

DEFAULT: 
DEFINITION: 

EXAMPLE: 



DAT A(address) 

where address is the desired base address of the data segment. 

See page 3-2, "How LOCATE Locates Segments." 

The DAT A(address) control locates the beginning of the data 
segment at the specified address. 



DATA C32768D) 



MEMORY 



SYNTAX: MEMORY (address) 

where address is the desired base address of the memory 
segment. 

DEFAULT: See page 3-2, "How LOCATE Locates Segments." 



DEFINITION: 



EXAMPLE: 



MEMORY (address) control locates the beginning of the 
memory segment at the specified address. 



MEMOR Y ( 1 



00011010100 



STACK 



SYNTAX: 

DEFAULT: 
DEFINITION: 

EXAMPLE: 



STACK(address) 

where address is the desired base address of the stack segment. 

See page 3-2, "How LOCATE Locates Segments." 

The STACK address control locates the beginning of the 
STACK segment at the specified address. 
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/common/ 



SYNTAX: 



DEFAULT: 
DEFINITION: 

EXAMPLE: 



/common segment name/ (address) 

where common segment name is the name of a FORTRAN 
common segment, and address is the desired base address for 
that segment. 

See page 3-2, "How LOCATE Locates Segments." 

The /common /(address) control locates the beginning of the 
specified FORTRAN common segment at the specified address. 



/NUNZIO/C30 77H) 



// 



SYNTAX: 1 1 (address) 

where address is the desired base address of an unnamed 
FORTRAN common segment. 

DEFAULT: See page 3-2, "How LOCATE Locates Segments." 

DEFINITION: The //(address) control locates the beginning of an unnamed 
FORTRAN common segment at the specified address. 



/ / (1 6384) 
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Introduction 

The ISIS-II LIB command allows you to create specially formatted files to contain 
libraries of object modules, to alter the contents of these files by adding new 
modules and deleting old ones. LIB will also provide a listing of the modules in a 
given library, if desired. Libraries can be used as input to the LINK program, which 
searches libraries for modules required by the other programs being linked. The 
library modules which LINK selects are those which satisfy external references in the 
other modules. 

The library manager program is called by the LIB command: 



LIB identifies itself with its sign-on message, followed by an asterisk prompt: 
ISIS-II LIBRARIAN Vx.y 

You will receive this prompt while in LIB after each command is completed. At the 
asterisk, you may enter any of the following LIB sub-commands: 

CREATE 

ADD 

DELETE 

LIST 

EXIT 

If a command line is longer than a line on your console (up to the maximum of 122 
characters allowed), you may continue it on the next line by entering an ampersand 
as the last non-blank character on the line before the <cr>. LIB responds to this with 
a double asterisk to let you know that it is ready for the continuation of the com- 
mand line. 

tCAUTJONl 

LIB uses a temporary file named LIB.TMP on the library file disk. If you 
have a file with this name, it will be destroyed. 

Appendix F lists the LIB error messages. 

The LIB sub-command definitions follow. 



CREATE 



SYNTAX: CREATE filename 



where filename is the name of the new library file. If another file 
exists with that name, an error message is given, and you are 
prompted for a new filename . 
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DEFINITION: 
EXAMPLE: 



The CREATE control creates an empty library file. You must 
then ADD modules to the file. 



CREATE CARNEG. LIB<cr> 



ADD 



SYNTAX: 



DEFINITION: 



ADD filename [{modname ,...),...] TO library 

where filename is the name of a file containing at least one 
object module, and modname is the name of a library module if 
that file is a library, too. If filename is a library file, but mod- 
names are not given, all modules in filename are copied into 
library. You may enter as many filenames or modnames as you 
wish, library is the name of an existing library file. 

This command inserts modules into the library. The modules 
may be elements of another library, or they may be in object 
files. If a module is in an object file, then it is placed in the 
library, and the directory in the library is updated. If the module 
is contained in a library, then you may specify the modules you 
wish to copy, or you may omit this list and let LIB copy all of the 
modules in the source library. If you specify the modules, then 
only those modules are copied into the library. If you omit the 
modnames, then LIB copies the entire input library into the 
library. 



EXAMPLE: 



BOOK, MONDO. LIBCBIG. GOOD) 



: ARN EG . LIB<cr> 



DELETE 



SYNTAX: DELETE library {modname,...) 

where library is the library from which you would like to 
remove some modules, and modname is the name of one of the 
modules you're removing. 

DEFINTITION: The DELETE control permits you to remove modules from 
libraries for which you have no need. DELETE removes the 
module and alters the directory of the library to reflect this 
change. 



EXAMPLE: 



DELETE CARNEG . LI B (ANDREW , DALEXcr> 
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ISIS-II Librarian 



LIST 



SYNTAX: 



DEFINITION: 



EXAMPLE: 



LIST library[(mod , 



[TOIistfile] [PUBLICS] 



where library is the library for which you need a list of modules, 
mod is one of those modules, and listfile is a file or an output 
device on which the list is to be printed. PUBLICS calls for a 
listing of the public symbols in each listed module. 

With the LIST command, you can examine the contents of your 
libraries. You can send this list to a file to print later, or you may 
print the list directly, depending upon listfile. If TOIistfile is 
omitted, the listing will be sent to the console output. With the 
library and modname controls, you may specify which of the 
modules in library LIB should list. The PUBLICS control lists 
the public symbols in each module after the module name. 

This LIST command 



** 



LIST CARNEG. LIBCPROJECTOR, F I LM , S L I D E) &<cr> 
TO :LP: PUB LI CS<cr> 



will cause the following to be listed on the line printer: 



PROJECTOR 
RACK 
NUMBER 
STATUS 

FILM 
HOUR 
MINUTE 
SECOND 
FRAME 

SLIDE 
TRAY 
POSITION 



Figure 4-1 . LIST Command Output 



EXIT 



SYNTAX: 

DEFINITION: 

EXAMPLE: 



EXIT 

The EXIT command returns control to ISIS-II. 
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CHAPTERS 

PROGRAM OVERLAYS 

AND LINKED LOADING 



Overview 

When a program is larger than the available memory, it is necessary to link the 
modules which make it up without combining them in one file. During execution, 
when one part of the program is finished, and another needed, the second can be 
loaded into the area of memory which had held the first. The same area of memory 
can hold different sections of the program at different times. This multiple use of 
the same memory area is called a program overlay. 

Under ISIS-II, modules to be loaded separately must be in different files. The first 
module is loaded by giving the name of the file which contains it as a command. The 
subsequent loads of the overlays must be performed by your program using the 
LOAD system call. 

In the typical use of LINK and LOCATE, modules with external references are com- 
bined with modules with matching public symbols to produce a module with no 
unresolved external references. In linking without combining, the external 
references must still be satisfied, but the program containing the public symbols 
must not be included. The LINK "PUBLICS" control links the public symbols 
from the input modules listed in the PUBLICS control to matching external 
references. The word PUBLICS tells LINK that the modules themselves are not to 
be combined into the output module, just the public symbols. 
For example: 



LINK A, PUBLICS(B,C) TO A. LNK 



results in a module A. LNK, whose external references to the absolute modules B and 
C are satisfied. B and C must be absolute modules for LINK to know the addresses 
of the public symbols they contain ( — obviously, since relocatable modules by 
definition do not contain absolute addresses). The typical usage of LINK before 
LOCATE is reversed. You must LOCATE B and C to create absolute modules 
(which may contain unresolved external references—it really doesn't matter) before 
you LINK them to A. 

Consider the following example. A "root" segment (the segment loaded first) calls 
segment "A." Segment "A," in turn, calls another segment, "AA." Next, segment 
"AAA" overlays segment "AA." Finally, the root segment calls segment "B," 
which overlays "A," but does not disturb "AAA," which it uses. The illustration 
below depicts this overlay scheme. The "cards" are program segments. The 
segments which overlap are overlays. Segments beside one another occupy different 
areas of memory. 




Figure 5-1. Overlays 
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All of these segments must be in different files because they are loaded separately. 
The root loads "A" and "B," and "A" loads "AA" and "AAA," 

If you locate the root first, you can use the memory map produced by LOCATE to 
determine the base address of "A" and "B." The maps produced by locating "A" 
and "B" can be used to determine the base address of "AA" and "AAA." You 
must locate "AA" above the top of "A," and "AAA" above the top of "A" or 
"B," depending upon which is higher. 

Suppose the modules make the following references to one another: 

The ROOT has external references to A and B. 

A has external references to AA, AAA, and the ROOT module. 

B contains external references to AAA and the ROOT. 

A A has external references to A. 

AAA contains external references to A and B. 

The absolute modules produced by LOCATE are as yet unsatisfied, and have been 
given the .TMP extension. The following LINK commands, performed upon these 
absolute modules, will produce a working program. 



LINK ROOT. TMP, PUB L I CS (A . TMP , B.TMP) TO ROO" 

LINK A. TMP, PUBLICSCROOT.TMP, AA.TMP, AAA. TMP) TO A 

LINK B.TMP, PUBLICS CROOT.TMP, A. TMP) <cr> 

LINK AA.TMP, PUBLI CS ( A . TMP) <cr>i 

LINK AAA. TMP, PUB LI CS (A . TMP , B.ink; ^:i? 



The modules are now fully connected but not combined, and are ready to run. You 
may wish to LOCATE all of the modules again just to make certain that all of the 
external references have been satisfied. 

NOTE 

When you link without combining to produce overlays, you must provide 
overlay management in your program. Before a segment makes use of 
another, both must be in memory. In the above example, ROOT must load 
A and B, and A must load AA and AAA. B does not load anything, A has 
already loaded AAA, and the root is loaded from the start. You must also 
make sure that you allocate memory properly — if segment B is longer than 
A, and AAA begins immediately above A, then AAA will be destroyed by 
loading B. If AA contains data which will be needed after it is overwritten, 
you must provide the means to save the data when AAA is loaded. Linking 
without combining provides the hooks for overlaying, but the runtime 
management must be designed into your software. 
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CHAPTER 6 
CODE CONVERSION PROGRAMS 



Introduction 



The two ISIS-II code converters exist to provide compatibility with systems employ- 
ing a hexadecimal object code format by converting programs between the ISIS-II 
format and the hexadecimal format, and vice-versa. 



The -code conversion programs change the character coding, but not the content of 
the files they process. Instructions and addresses will be the same, but expressed in a 
different format. 



HEXOBJ 



SYNTAX: 



HEXOBJ hex file TO abs file [ST ART (address)] 

where hexfile contains hexadecomal MCS-80/85 code, absfile 
is the output file to contain the ISIS-II compatible absolute 
object module, and address is the desired start address of the 
output module. 



DEFINITION: HEXOBJ converts hexadecimal-encoded MCS-80/85 code into 
ISIS-II compatible form. The output module receives the name 
portion of absfile. HEXOBJ produces a symbol table only if 
symbols were defined in the hexfile . 



With the optional START(address) control, you may specify 
the start address of the object module. This address may be 
given in any of the bases described on page — . — of chapter — . 
If START(address) is omitted, then HEXOBJ will search the 
end-of-file record of hexfile for that information. The address 
stored there is determined by an assembly-language statement, a 
numeric lable on the first statement of a PL/M program, or a 
compiler control. If none of these have been used, then there will 
be no start address in hexfile, and HEXOBJ will set the start 
address of absfile to 0. You cannot load and run such a pro- 
gram under ISIS-II, since all memory below 3000H is reserved. 



EXAMPLE: 



HEXOBJ :F1 : PR IMO . H EX TO ABS. OBJ STARTC3300H) 
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OBJHEX 



SYNTAX: 



OBJHEX absfi/e TO hexfile 



where absfile contained an ISIS-II absolute object module, and 
hexfile will contain hexadecimal-format object code. 

DEFINITION: OBJHEX is the converse of HEXOBJ— it produces hexadecimal 
object code from and ISIS-II formatter file. The starting address 
is obtained from absfile, and the hexadecimal code does not 
contain a symbol table. You may wish to convert files to hexa- 
decimal format for loadng into PROM, or so that the program 
may run on a system which uses hexadecimal coding. 



EXAMPLE: 



OBJHEX SOURCE. ABS TO :F2:SINK.HEX 



6-2 




APPENDIX A 
HEXADECIMAL PAPER TAPE FORMAT 



Object code is stored on paper tape in an ASCII representation of the program in 
memory. The code is blocked into records, each of which contains the record type, 
length, type, memory load address, and checksum in addition to the data. Figure 
A-l shows the frames of a tape record. 



CHECKSUM 



RECORD TYPE 



LOAD 
ADDRESS 



RECORD 
LENGTH 



RECORD MARK 



Figure A-l . Paper Tape Record Format 
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The Record Mark is a colon (3 AH) and is used to signal the start of a record. 

The Record Length is the count of the data bytes in the record. A record length of 
zero indicates end-of-file. 

The Load Address specifies the address at which the first data byte will be loaded. 
The successive data bytes will be stored in successive memory locations. 

The Record Type specifies the type of this record. All data records are type 0. End- 
of-file records can be type or 1 . 

The Data consists of two frames per memory word. The data is represented by hex- 
adecimal values 00H through FFH. 

The Checksum is the negative of the sum of all 8-bit bytes in the record, beginning 
with the Record Length and ending with the last Data byte, evaluated modulo 256. 
The sum of all bytes in the record (including the checksum) should be zero. 
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APPENDIX B 
HEXADECIMAL-DECIMAL CONVERSION 



The following table is for hexadecimal to decimal and decimal to hexadecimal con- 
version. To find the decimal equivalent of a hexadecimal number, locate the hex- 
adecimal number in the correct position and note the decimal equivalent. Add the 
decimal numbers. 

To find the hexadecimal equivalent of a decimal number, locate the next lower 
decimal number in the table and note the hexadecimal number and its position. Sub- 
tract the decimal number from the table from the starting number. Find the dif- 
ference in the table. Continue this process until there is no difference. 



BYTE 


BYTE 


HEX 


DEC 


HEX 


DEC 


HEX 


DEC 


HEX 


DEC 


























1 


4,096 


1 


256 


1 


16 


1 


1 


2 


8,192 


2 


512 


2 


32 


2 


2 


3 


12,288 


3 


768 


3 


48 


3 


3 


4 


16,384 


4 


1,024 


4 


64 


4 


4 


5 


20,480 


5 


1,280 


5 


80 


5 


5 


6 


24,576 


6 


1,536 


6 


96 


6 


6 


7 


28,672 


7 


1,792 


7 


112 


7 


7 


8 


32,768 


8 


2,048 


8 


128 


8 


8 


9 


36,864 


9 


2,304 


9 


144 


9 


9 


A 


40,960 


A 


2,560 


A 


160 


A 


10 


B 


45,056 


B 


2,816 


B 


176 


B 


11 


C 


49,152 


C 


3,072 


C 


192 


C 


12 


D 


53,248 


D 


3,328 


D 


208 


D 


13 


E 


57,344 


E 


3,548 


E 


224 


E 


14 


F 


61 ,440 


F 


3,840 


F 


240 


F 


15 



B-l 




APPENDIX C 
ASCII CODES 



Table C-l . ASCII Code List 



Decimal 


Octal 


Hexadecimal 


Character 





000 


00 


NUL 


1 


001 


01 


SOH 


2 


002 


02 


STX 


3 


003 


03 


ETX 


4 


004 


04 


EOT 


5 


005 


05 


ENQ 


6 


006 


06 


ACK 


7 


007 


07 


BEL 


8 


010 


08 


BS 


9 


011 


09 


HT 


10 


012 


0A 


LF 


11 


013 


OB 


VT 


12 


014 


OC 


FF 


13 


015 


0D 


CR 


14 


016 


0E 


SO 


15 


017 


OF 


SI 


16 


020 


10 


DLE 


17 


021 


11 


DC1 


18 


022 


12 


DC2 


19 


023 


13 


DC3 


20 


024 


14 


DC4 


21 


025 


15 


NAK 


22 


026 


16 


SYN 


23 


027 


17 


ETB 


24 


030 


18 


CAN 


25 


031 


19 


EM 


26 


032 


1A 


SUB 


27 


033 


1B 


ESC 


28 


034 


1C 


FS 


29 


035 


1D 


GS 


30 


036 


1E 


RS 


31 


037 


1F 


US 


32 


040 


20 


SP 


33 


041 


21 


! 


34 


042 


22 


" 


35 


043 


23 


# 


36 


044 


24 


$ 


37 


045 


25 


% 


38 


046 


26 


& 


39 


047 


27 


• 


40 


050 


28 


( 


41 


051 


29 


) 


42 


052 


2A 




43 


053 


2B 


+ 


44 


054 


2C 


' 


45 


055 


2D 


.— 


46 


056 


2E 




47 


057 


2F 


/ 


48 


060 


30 





49 


061 


31 


1 


50 


062 


32 


2 


51 


063 


33 


3 


52 


064 


34 


4 


53 


065 


35 


5 


54 


066 


36 


6 


55 


067 


37 


7 


56 


070 


38 


8 


57 


071 


39 


9 


58 


072 


3A 


; 


59 


073 


3B 




60 


074 


3C 


< 


61 


075 


3D 


= 


62 


076 


3E 


> 


63 


077 


3F 


? 



Decimal 


Octal 


Hexadecimal 


Character 


64 


100 


40 


@ 


65 


101 


41 


A 


66 


102 


42 


B 


67 


103 


43 


C 


68 


104 


44 


D 


69 


105 


45 


E 


70 


106 


46 


F 


71 


107 


47 


G 


72 


110 


48 


H 


73 


111 


49 


I 


74 


112 


4A 


J 


75 


113 


4B 


K 


76 


114 


4C 


L 


77 


115 


4D 


M 


78 


116 


4E 


N 


79 


117 


4F 





80 


120 


50 


P 


81 


121 


51 


Q 


82 


122 


52 


R 


83 


123 


53 


S 


84 


124 


54 


T 


85 


125 


55 


U 


86 


126 


56 


V 


87 


127 


57 


w 


88 


130 


58 


X 


89 


131 


59 


Y 


90 


132 


5A 


z 


91 


133 


5B 


[ 


92 


134 


5C 




93 


135 


5D 


] 


94 


136 


5E 


A 


95 


137 


5F 


— 


96 


140 


60 


' 


97 


141 


61 


a 


98 


142 


62 


b 


99 


143 


63 


c 


100 


144 


64 


d 


101 


145 


65 


e 


102 


146 


66 


f 


103 


147 


67 


g 


104 


150 


68 


h 


105 


151 


69 


i 


106 


152 


6A 


j 


107 


153 


6B 


k 


108 


154 


6C 


I 


109 


155 


6D 


m 


110 


156 


6E 


n 


111 


157 


6F 





112 


160 


70 


P 


113 


161 


71 


q 


114 


162 


72 


r 


115 


163 


73 


s 


116 


164 


74 


t 


117 


165 


75 


u 


118 


166 


76 


V 


119 


167 


77 


w 


120 


170 


78 


X 


121 


171 


79 


y 


122 


172 


7A 


z 


123 


173 


7B 


1 


124 


174 


7C 


1 


125 


175 


7D 




126 


176 


7E 




127 


177 


7F 


DEL 
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APPENDIX D 
ISIS-II ERROR MESSAGES 



Introduction 

This appendix lists the error messages issued by ISIS-II. These errors can occur at 
the invocation of any of the ISIS-II routines, or can be generated by error conditions 
encountered in the operation of those routines. 

The error numbers are divided into three groups as follows: 

• Errors 1-99 are those which occur within ISIS-II resident routines. 

• Errors 100-199 are reserved for user- written program errors. 

• Errors 200-255 are generated by ISIS-II non-resident routines. 

ISIS-II errors can be either fatal or non-fatal. Fatal errors halt program execution 
immediately, and do not permit recovery. Fatal errors result in the return of control 
to ISIS-II, which overwrites some of the user program area. ISIS-II displays this 
error message: 

ERROR nnn USER PC mmmm 

Where nnn is the error number, and mmmm is the address in the program counter 
when the error occurred. 

Non-fatal errors halt the execution of the current program, but do not return control 
to ISIS-II. User-written error handling routines can restore the program to the pre- 
error condition. If the error occurs in a program invocation, the errant input is 
echoed, and an appropriate error message is given, as below: 



COPY :G1 : C RED I T TO :F0:CRDT<cr: 



:G1:CREDIT, UNRECOGNIZED DEVICE NAME 

The non-fatal errors encountered by some ISIS-II non-resident routines have 
appropriate error messages — these are included in the error descriptions. 

In the list below, fatal errors are identified by an asterisk before the error 
description. 

ISIS-II Error Descriptions 

No error detected. This is the normal state. 

*1 Too few buffers have been allocated than are required to meet the current 
program needs. Trying to allocate more than the maximum of 19 buffers will 
cause this error as well. 

2 ILLEGAL AFTN ARGUMENT 

The value specified as an AFTN (Active File Table Number) is either not in the 
table of open files or is otherwise incorrect. Such an error will occur when your 
program tries to read a file which has been closed. To recover from this error, 
replace the AFTN with a correct value. 

*3 Attempt to open more than six files simultaneously. The AFT can contain, at 
most, six files. To recover from this error, close one file, thereby freeing an AFT 
position. 
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4 INCORRECTLY SPECIFIED FILENAME 

You have entered a filename which is illegal for one of these reasons: 

• It contains more than six letters, or has an extension of more than three 
letters. 

• It contains illegal characters. Filenames may contain only the characters 
A - Z and the numerals 0-9. 

• The first character of the file name is a numeral. Filenames must begin with 
a letter. 

5 UNRECOGNIZED DEVICE NAME 

The device name specified is not a legal device. Check the ISIS-II User's Guide 
for a full list of legal devices. 

6 ATTEMPT TO WRITE TO AN INPUT DEVICE 

It is impossible to write to an input device such as a file open for input or any of 
the terminal input files. :CI:, :VI:, and :TI: are all input devices. 

*7 Insufficient disk space. The disk is full. Before writing to a disk, make sure that 
it has sufficient room. 

8 ATTEMPT TO READ FROM AN OUTPUT DEVICE 

Some devices, like the line printer (:LP:), are output-only devices. You cannot 
read from them. :CO:, :VO:, and :TO: are output-only, and cannot be read. 

9 DISK DIRECTORY FULL 

There is no room in the disk directory for any new files. There is a limit of 200 
files for floppy disks, and 992 for hard disks. 

10 NOT ON SAME DISK 

The second file specified is not on the same disk as the first, but it is expected to 
be. An attempt to rename a file to another disk will produce this error. 

11 FILE ALREADY EXISTS 

The specified filename matches one already on the disks. Many ISIS-II routines 
which produce this error allow you to decide whether to replace the old file with 
the specified one, or to change the name of the new file. 

12 FILE IS ALREADY OPEN 

Only the console input and output (:CI: and :CO:) may be opened more than 
once without being closed. Other files can only be opened once. Check your 
program for these possible causes: 

• The program makes an unintended jump to the OPEN statement. 

• The filename is misspelled in the second OPEN statement. 

• You have coded more than one OPEN statement for the file. 

13 NO SUCH FILE 

The file specified is not in the directory of the disk specified. Probable causes 
are an incorrect filename or device designator. 
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14 WRITE PROTECTED 

The intended WRITE, RENAME, or DELETE operation could not be per- 
formed because the file is write protected (attribute W). This error also occurs 
when one of these operations is attempted on a disk whose write-protect slot is 
open. 

*15 Attempted load into ISIS-II reserved area. The system will not allow you to load 
programs below 3000H because that area is reserved for ISIS-II resident pro- 
grams. Such a load operation would not permit the use of system calls, and 
would make return of control to ISIS-II impossible. 

*16 Illegal load format. The file to be loaded is not an ISIS-II absolute- format file. 
To be loaded and executed by the ISIS-II system, code must be in the proper 
absolute format. 

17 NOT A DISK FILE 

An attempted reference to a disk file has been made using a non-disk device 
identifier. An example would be :HP:THIS in place of :F1:THIS. This error 
differs from number 5 in that the device name given here is a legal device name, 
but not the correct one. 

*18 This error reports that an ISIS system call was made from a program with an 
illegal command number. 

19 ATTEMPTED SEEK ON NON-DISK FILE 

Seeks on devices other than disk drives are invalid, with the exception of :BB:. 
Check for possible errors in AFTNs or misspellings. 

20 ATTEMPTED BACK SEEK TOO FAR 

The seek went beyond the beginning of a file. MARKER is set to zero. See the 
ISIS- II User's Guide. 



21 CAN'T RESCAN 

Files which are not open for line-editing cannot be rescanned. 

22 ILLEGAL ACCESS MODE TO OPEN 

There are only three legal access mode parameters for OPEN: 

1 Input (Read-only) 

2 Output (Write-only) 

3 Update (Read- Write) 

Error 22 can also indicate that the access mode selected is not legal for this file. 

23 MISSING FILENAME 

A filename is expected as an argument to a command, and is not present. 
DELETE <cr> (no file designated for deletion) is a case for which this error 
would occur. 
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*24 Disk I/O error. An additional message follows the usual error number line 

STATUS=00nn 
D=x T=yyy S=zzz 

where x is the drive number 
yyy is the track address 
zzz is the sector address 
nn indicates the following: 



For Floppy disks: 


01 


Deleted record 


02 


Data field CRC error 


03 


Invalid address mark 


04 


Seek error 


08 


Address error 


0A 


ID field CRC error 


0E 


No address mark 


OF 


Incorrect address mark 


10 


Data overrun or underrun 


20 


Attempt to write on write protected disk 


40 


Drive has indicated a write error 


80 


Drive not ready 


For Hard disks: 


01 


ID field miscompare 


02 


Data field CRC error 


04 


Seek error 


08 


Bad sector address 


0A 


ID field CRC error 


0B 


Protocol violation 


OC 


Bad track address 


0E 


No ID address mark or sector not found 


10 


Format error 


20 


Attempt to write on write protected drive 


40 


Drive indicates write error 


80 


Drive not ready 



Error 24 may indicate permanent damage to the disk. If so, then you may wish 
to copy the salvagable files to a new disk with the COPY command. 

25 Echo files, like all other I/O files, must have an AFTN which is between and 
255. Echo files must be open for output. Check that both of these requirements 
are met. 

26 ILLEGAL ATTRIBUTE IDENTIFIER 

The second parameter to the ATTRIB system call (not to be confused with the 
ATTRIB program) must be 

Invisible file 

1 System file 

2 Write-protected file 

3 Format attribute file 
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27 ILLEGAL SEEK COMMAND 

The MODE for the SEEK system call must be one of these values: 

Return marker location 

1 Move marker backward 

2 Move marker to specific location 

3 Move marker forward 

4 Move marker to end of file 

Error 27 can also indicate that the mode selected is not possible for the specified 
file. 

28 MISSING EXTENSION 

A filename extension is expected but not entered. Check for mistyped filename. 

*29 Premature EOF. An unexpected end-of-file has been encountered from the 
console or an input file. Check for possible misspellings or other errors which 
might cause the incorrect input file to be read. 

*30 Drive not ready. The disk drive specified is not ready. Check the drive to make 
certain that the disk is inserted correctly, and the door is completely closed and 
latched. 

31 CANT SEEK ON WRITE ONLY FILE 

Seeks can only be performed on files open for update or read. This non-fatal 
error can be processed by selecting the correct file or by closing and re-opening 
the specified file in one of these modes. 

32 CAN'T DELETE OPEN FILE 

You must close a file before attempting to delete. Check to be certain that the 
filename is correct. 

*33 Illegal system call parameter. Check all parameters of the call at the location 
specified in the PC portion of the error message. 

*34 Illegal return switch in LOAD system call. The only legal values are 

Control is returned to the calling program. The debug toggle is 
unchanged. 

1 Control is returned to the loaded program, and the debug toggle 
is reset. 

2 Control is returned to the Monitor. To restart program, use the 
Monitor "G" command. 

35 SEEK PAST EOF 

The file is opened for input, and a SEEK has been attempted beyond the end-of- 
file. You may SEEK beyond the end of a file open for update. 

Error Messages for Nonresident System Routines 

201 UNRECOGNIZED SWITCH 

A character not known as a switch for this routine was entered. The Escape 
character, for example, is not allowed in invocation lines, so COPY A TO 
B<esc> is illegal. 
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202 UNRECOGNIZED DELIMITER 

A character which is not allowed in a name and is not recognized as a valid 
delimiter has been entered. 

203 INVALID SYNTAX 

A parameter in a system call was inappropriate in the context used. Such a case 
is COPY A FOR B, where FOR is inappropriate in the COPY command. 

204 Premature end-of-file. See error 29. 

206 ILLEGAL DISK LABEL 

The label entered in the IDISK or FORMAT command is either too long or 
violates the legal character rules for disk labels. These rules are the same as for 
files. 

207 No END statement found in input. The input file being read lacks the expected 
END record. Check for misspelled input file name. Other causes can be a prob- 
lem in translating or linking the file. 

208 CHECKSUM ERROR 

The bits of the records read do not add up properly. Either an I/O error has 
occurred or the input source is damaged. Check for damage to the disk, paper 
tape, or other input medium. 

209 RELO FILE SEQUENCE ERROR 

Either an I/O error has occurred, or an incorrect input file has been specified. 

210 INSUFFICIENT MEMORY 

The required or requested amount of RAM is not available. Either too much 
RAM was requested, or some hardware problem has arisen. 

211 RECORD TOO LONG 

A record longer than expected has been encountered. Make sure the input file is 
correct. 

212 ILLEGAL RELO TYPE 

Relocation types must be one of these: 



A Absolute, non-relocatable 

B Byte-relocatable 

P Page-relocatable 

I In-page relocatable 



See Chapter 2 for an explanation of relocation types. 

213 FIXUP BOUNDS ERROR 

The address required violates numeric bounds on addresses. See Chapter 1 for 
an explanation of Intellec memory configuration. 
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214 ILLEGAL SUBMIT PARAMETER 

One of the actual parameters to be substituted for a formal parameter within a 
submit file is in error. See the ISIS-H User's Guide. 

215 ARGUMENT TOO LONG 

The number of characters in an actual argument may not exceed 31 . 

216 TOO MANY PARAMETERS 

More parameters supplied than defined, or the limit of 10 parameters has been 
exceeded. 

217 OBJECT RECORD TOO SHORT 

One of the records in an object module file has fewer bytes than were expected. 
This error can be caused by an I/O error or by an incorrect file specification. 

218 ILLEGAL RECORD FORMAT 

The record format must conform to Intel standard. Check for a misspelled 
filename or damage to the disk or input medium. 

219 PHASE ERROR 

The expected phase input (for the next step of a translation process) is incor- 
rectly specified. 

220 No end-of-file record in object module file. An end-of-file record must be 
contained in every object file according to the standard object file format. 

221 Segment overflow during LINK. Because of the size of the Intellec memory 
area, no segment may exceed 64K bytes in length. This error indicates that some 
segment has exceeded this limit. 

222 Unrecognized record in object module file. Here, again, the object module file 
does not match the standard object module format. 

223 Fixup record pointer is incorrect. The fixup record allows LINK to adjust the 
addresses of inter- or intra-segment references, and external references. If the 
pointer is incorrect, then LINK cannot correctly adjust the addresses. 

224 Illegal record sequence in LINK object module file. The records within one of 
the LINK object module files are out of order. This could indicate an I/O error, 
damaged disk, or an incorrect file specification. 

225 Illegal module name specified. Module names must conform to the standard 
format explained on page — . — . 

226 Module name exceeds 31 characters. There is a 31 character limit on the length 
of filenames. 

227 Command syntax requires left parenthesis. Self explanatory. 

228 Command syntax requires right parenthesis. Self explanatory. 

229 Unrecognized control specified. One of the controls to a command is probably 
misspelled, or is not a legal control for this command. Example: LINK A.OBJ, 
B.LIB TO AB.OBJ START(3000H). The START control is a LOCATE con- 
trol, not a LINK control. 
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230 Duplicate symbol found. If LINK encounters a symbol which is used in more 
than one module, this message is issued. If it indicates an error, then you must 
change the source code of one of the modules so that the symbols differ. 

231 File already exists. See error 1 1 . 

232 Unrecognized command. The command specified does not exist. Check for 
misspellings. Check the ISIS-II User's Guide for a list of legal commands. 

233 Command syntax requires a "TO" clause. Some commands, such as COPY, 
require a TO <filename> clause. 

234 CANNOT FORMAT FROM TARGET DRIVE 

The source disk for formatting another disk must be in a different drive from 
the target drive, except when the single drive mode is selected with the IDISK 
command. 

235 NON-DISK DEVICE 

You have specified a non-disk device, such as :LP:, when the system expects a 
disk device. You cannot use IDISK on the line printer, for example. 

236 More than 249 common segments in input files. No more than this number can 
be processed. This limit should not impose restrictions under normal 
circumstances. 

237 Specified common segment not in object file. You have specified a non-existent 
common segment in the "/common name/" control to LOCATE. 

238 Illegal stack content record in object file. The stack content record in the object 
file does not conform to the expected format. This usually indicates an I/O 
error. 

239 No module header record in input object file. Again, an error in the format to 
the input object module file, possibly due to an I/O error. Check also for a 
damaged disk. 

240 Program exceeds 64K bytes. Obviously, this will not fit into the Intellec 
memory. You may wish to subdivide the program and use overlays so that the 
memory needed at any one time is less than 64K bytes. Chapter 4 explains the 
use of program overlays. 
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LINK ERROR MESSAGES 



Introduction 

Errors encountered by LINK cause an unnumbered message to be sent to the current 
console device and, in the case of non-fatal errors, to the LINK map. Fatal error 
messages are sent only to the console device because processing is halted. Non-fatal 
errors do not halt LINK processing. 

Fatal Errors 

Command Errors 

Errors caused by improper command entry are followed by a partial copy of the 
errant command followed by a number sign (#) in the vicinity of the error. 

ERROR MESSAGE 

partial copy of command# 

The following messages identify improper command errors. 

INVALID SYNTAX 

This message occurs when some part of the command is not recognized. The prob- 
lem can be a mistyped keyword, a missing comma, or an non-blank character 
following a line-continuation ampersand. 

DUPLICATE FILE NAME 

The same file is specified as the input and output file. 

'TO' EXPECTED 

The command syntax requires a 'TO' clause for the output file. This message 
indicates that the clause has been omitted. 

LEFT PARENTHESIS EXPECTED 
A PUBLICS, NAME, or PRINT keyword is not followed by a "(". 

RIGHT PARENTHESIS EXPECTED 
The list following one of the three keywords listed above is not terminated with a 

INVALID NAME 

The module name contains an illegal character, or begins with a numeral. See 
Chapter 2 for the rules concerning module names. 

NAME TOO LONG 

Module names may not be longer than 31 characters. 

UNRECOGNIZED CONTROL 
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A character string other than NAME, MAP, or PRINT has been encountered. 

Input File Errors 

If there is an error in the internal format of a specified input file, one of the follow- 
ing messages will be generated. These errors can be the result of something as simple 
as a misspelling of a filename, or the error may be the result of problems generated 
by a language translator or a previous LINK. If the filenames all appear to be cor- 
rect, then compile the program and try to LINK it again. If the problem persists, and 
the fault seems to be either LINK or the translator, report it to Intel with a Software 
Problem Report. 

filename, PREMATURE EOF (see ISIS-II error 29) 
filename, CHECKSUM ERROR (see ISIS-II error 204) 
filename, RECORD TOO LONG (see ISIS-II error 21 1) 
filename, ILLEGAL RELO RECORD (see ISIS-II error 212) 
filename, FIXUP BOUNDS ERROR (see ISIS-II error 213) 
filename, ILLEGAL RECORD FORMAT (see ISIS-II error 218) 
filename, NO EOF 

This error indicates that the file being read in has no end-of-file 

record. LINK cannot process such a file, 
filename, BAD RECORD SEQUENCE 

The records in the object module file specified are out of order. 

LINK cannot process a file unless the records are in the proper order, 
filename, ILLEGAL STACK CONTENT RECORD (see ISIS-II error 238) 
filename, NO MODULE HEADER RECORD 

The file named lacks the module header record which contains 

information needed by LINK to process the file, 
filename, NOT A LIBRARY 

You have specified a list of library modules following a file which is 

not a library, 
filename, SEGMENT TOO LARGE (see ISIS-II error 221) 
filename, INSUFFICIENT MEMORY 

LINK cannot create the output file specified because there is not 

enough room in memory for the LINK work space, which consists 

mainly of the symbol table. 

Non-Fatal Error Messages 

Non-fatal errors issued by LINK are written to the map file and to the current con- 
sole device (if different). 

MORE THAN 1 MAIN MODULE, CONFLICT IN modname 

This indicates that LINK found more than one main module in the input list. The 
module named in the message is the second main module found. All of the main 
modules are included in the output module, but the starting address of the output 
module is taken from the first main module detected. 

name-MULTIPLY DEFINED, DUPLICATE IN modname 

The public name given here was defined in more than one module. The second 
definition was detected in the module specified. 

MODULE NOT IN LIBRARY, LOOKING FOR filename(modname) 

The module named has not been found in the library given in the error message. 

/name/-UNEQUAL COMMON LENGTH, CONFLICT IN modname 

Two named common segments with the same name but different lengths were 
found. The module containing the second segment found is given in the message. 
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Introduction 

Errors encountered by LOCATE cause an unnumbered message to be sent to the 
current console device and, in the case of non-fatal errors, to the memory map. 
Fatal error messages are sent only to the console device because processing is halted. 
Non- fatal errors do not halt LOCATE processing. 



Fatal Errors 



Command Errors 

Errors caused by improper command entry are followed by a partial copy of the 
errant command followed by a number sign (#) in the vicinity of the error. 

ERROR MESSAGE 
partial copy of command* 

The following messages identify improper command errors. 

INVALID SYNTAX 

This message occurs when some part of the command is not recognized. The prob- 
lem can be a mistyped keyword, a missing comma, or an non-blank character 
following a line-continuation ampersand. 

'TO' EXPECTED 

The command syntax requires a 'TO' clause for the output file. This message 
indicates that the clause has been omitted. 

LEFT PARENTHESIS EXPECTED 

A COLUMNS, ORDER, START, STACKSIZE, CODE, DATA, STACK, 
MEMORY, /common name/, //, NAME, or PRINT keyword is not followed by a 

RIGHT PARENTHESIS EXPECTED 

The list following one of the twelve keywords listed above is not terminated with a 

INVALID NAME 

The module name or /common name/ contains an illegal character. See Chapter 2 
for the rules concerning module names. 

NAME TOO LONG 

Module names and /common name/s have a length limit of 31 characters. 

common name, COMMON NOT FOUND 
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The input module does not contain the common segment specified in the command. 

UNRECOGNIZED CONTROL 

A character string other than NAME, MAP, PRINT, COLUMNS, SYMBOLS, 
LINES, PUBLICS, PURGE, ORDER, CODE, DATA, STACK, STACKSIZE, 
MEMORY, /common name/, //, RESTARTO, START, or STACKSIZE has been 
encountered. 

Input File Errors 

If there is an error in the internal format of a specified input file, one of the follow- 
ing messages will be generated. These errors can be the result of something as simple 
as a misspelling of a filename, or the error may be the result of problems generated 
by a language translator or during LINK. If so, then translate the source code again, 
and re-LOCATE the object module. If the problem persists, and seems to be the 
fault of LINK or the translator, report it to Intel with a Software Problem Report. 

filename, PREMATURE EOF (see ISIS-II error 29) 
filename, CHECKSUM ERROR (see ISIS-II error 204) 
filename, RECORD TOO LONG (see ISIS-II error 211) 
filename, ILLEGAL RELO RECORD (see ISIS-II error 212) 
filename, FIXUP BOUNDS ERROR (see ISIS-II error 213) 
filename, ILLEGAL RECORD FORMAT (see ISIS-II error 218) 
filename, NO EOF 

This error indicates that the file being read in has no end-of-file 

record. LOCATE cannot process such a file, 
filename, BAD RECORD SEQUENCE 

The records in the object module file specified are out of order. 

LOCATE cannot process a file unless the records are in the proper 

order, 
filename, ILLEGAL STACK CONTENT RECORD (see ISIS-II error 238) 
filename, NO MODULE HEADER RECORD 

The file named lacks the module header record which contains 

information needed by LOCATE to processs file, 
filename, PROGRAM EXCEEDS 64K (see ISIS-II error 221) 
filename, INSUFFICIENT MEMORY 

LOCATE cannot process the input file specified because there is not 

enough room in memory for work space. 



Non-Fatal Error Messages 

Non-fatal errors issued by LOCATE are written to the map file and to the current 
console device (if different). 

IN-PAGE SEGMENT > 256 BYTES COERCED TO PAGE BOUNDARY 

An in-page relocatable segment has been discovered which is longer than the limit of 
256 bytes for such segments. See Chapter 2 for a description of relocation types. 

UNSATISFIED EXTERNAL(n) external name 

This error occurs when an unsatisfied external name is encountered in the input file. 
The number (n) is the count of the number of unsatisfied names uncovered so far. It 
is used to identify the unsatisfied name in the following message. 

REFERENCE TO UNSATISFIED EXTERNAL(n) AT xxxxH 
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This message reports the address of the reference to the unsatisfied external name 
identified by (n). 

(MEMORY OVERLAP FROM xxxxH THROUGH yyyyH 

This message is issued if the same memory location is defined in more than one pro- 
gram segment. 
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Introduction 

All LIB error messages are nonfatal because LIB is an interactive program. The 
command which caused the error will be aborted, but LIB will not be interrupted. 

Command Errors 

Errors caused by improper command entry are followed by a partial copy of the 
incorrect command with a number sign (#) in the vicinity of the error. 

ERROR MESSAGE 
partial command* 

The following are the LIB command error messages: 

INSUFFICIENT MEMORY 

LIB cannot execute the command given because it requires more memory than in 
available in the intellec system. 

INVALID MODULE NAME 

A module listed in the command is incorrectly specified. Module names must con- 
form to the format given in chapter 2. 

INVALID SYNTAX 

Check the command for one of the following: 

Misspelled keywords. 

Ampersand followed by a non-blank character. 

ADD: TO filename not followed by a <cr>. 

DELETE: libname(modname) not followed by a <cr>. 

DELETE: modname not specified. 

CREATE: filename not followed by a <cr>. 

LIST: TO filename not followed by PUBLICS or a <cr>. 

LEFT PARENTHESIS EXPECTED 
There is a missing "("in the command. 

RIGHT PARENTHESIS EXPECTED 
There is a missing ")" in the command. 

MODULE NAME TOO LONG 
The specified module name exceeds 31 characters. 

'TO' EXPECTED 
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The TO filename is omitted in the ADD command. 
UNRECOGNIZED COMMAND 

An illegal or misspelled command was entered. The only legal commands are ADD, 
CREATE, DELETE, EXIT, and LIST. 

File or Module Errors 

The following errors indicate that there is some problem with the file or module 
specified. There is no partial copy of the command given with these error messages. 

FILE ALREADY EXISTS 

The file specified in the CREATE command already exists. Choose a new name for 
the library. 

filename, CHECKSUM ERROR (see ISIS-II error 208) 

Filename, DUPLICATE SYMBOL IN INPUT 

You have attempted to ADD a file which contains a PUBLIC symbol already within 
the library. 

filename, ILLEGAL RECORD FORMAT (see ISIS-II error 218) 

filename, NOT LIBRARY 

The specified file is not a library. 

filename, OBJECT RECORD TOO SHORT (see ISIS-II error 217) 

filename(modname): NOT FOUND 

You have attempted to delete a module which does not exist. Check for misspelling 
of the filename or module name. 

modname-ATTEMPT TO ADD DUPLICATE MODULE 

The specified module name already appears within the library. 

symbol-ALREADY IN LIBRARY 

You have attempted to add a module that contains a PUBLIC symbol which is 
already in the library. 
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absolute address, 1-1, 2-2, 2-5 
absolute segment, 2-2, 2-5 
ADD command (LIB), 4-2 
address 

absolute, 1-1, 1-4 

base, 1-4 

relative memory, 1-1, 1-5 

relative start, 1-4 

start assigned by HEXOBJ, 6-1 
ampersand (&), as continuation character 

in LIB, 4-1 

in LINK, 2-3f . 

in LOCATE, 3-6 
at sign (@), in module names, 2-6, 3-9 
ATTRIB system call, 3-5 

base address, 1-4 
blank common, 3-14 
braces, as notation (-C >), iii 
brackets, as notation ( [ ] ), iii 
buffer areas 

allocating, 3-5 f. 

inISIS-II, 1-3,3-5 
byte-relocatable segments, 2-2, 2-5 

CODE 
control (LOCATE), 3-12 
in ORDER control, 3-12 
see also ORDER 
code segment, 1-4, 2-2 

where loaded by LOCATE, 3-2 
COLUMNS control 
in LOCATE, 3-6f . 
interaction with SYMBOLS, 
PUBLICS, 
LINES, 3-7 
commands 
LIB, 4-1 ff. 

ADD, 4-2 

CREATE, 4-1 

DELETE, 4-2 

EXIT, 4-3 

LIST, 4-3 
LINK, 2-3ff . 

MAP, 2-4 

NAME, 2-6 

PRINT, 2-6 

PUBLICS, 2-3, 5-1 
LOCATE, 3-1 ff. 

CODE, 3-12 

COLUMNS, 3-6 

/common/, 3-14 

// (blank common), 3-14 

DATA, 3-13 

LINES, 3-7 

MAP, 3-8 

MEMORY, 3-13 

NAME, 3-9 

ORDER, 3-12 



PRINT, 3-9 
PUBLICS, 3-9 
PURGE, 3-10 
RESTARTO, 3-11 
STACK, 3-13 
STACKSIZE, 3-12 
START, 3-10 
common segments 
blank, 3-14 
in LOCATE, 3-3 
named, 3-14 
unnamed, 3-14 
/common/ control (LOCATE), 3-14 
CONSOL system call, 3-5 
continuation character (&) 

see ampersand 
CREATE command (LIB), 4-1 

DATA control (LOCATE), 3-13 
data segment, 1-4, 2-2 

in ORDER control (LOCATE), 3-12 

where loaded by LOCATE, 3-2 

see also ORDER 
debugging, 1-2 
defaults 

order of segments, 3-3 

see individual commands for defaults 
DELETE command (LIB), 4-2 
DELETE system call, 3-5 

ellipses, in syntax notation, iii 
error messages 
disk I/O, D-4 
ISIS-II, D-lff. 
LIB 
command errors, G-l 
file or module errors, G-2 
LINK, E-lff. 

input file errors, E-2 
LOCATE, F-lff. 
input file errors, F-2 
EXIT command (LIB), 4-3 
extensions, filename, 1-6, 2-4, 3-6, 4-1 
external references, 1-4, 1-6, 4-1, 5-1 

file name extensions, 1-6, 2-4, 3-6, 4-1 

gaps 
how generated, 2-3, 3-3, 3-4 
how reported (LINK), 2-3, 2-5 

hexadecimal paper-tape format, A-l 
HEXOBJ, 6-1 
HIGH operator, 3-2f . 

iAPX 86,88 family, 1-1 
in page-relocatable segments, 2-2, 2-5 
interrupts, used by ISIS-II, 1-3 
inter-segment references, 1-4, l-5f. 
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intra-segment references, 1-4, l-5f. 
invocation 

LIB, 4-1 

LINK, 2-3 

LOCATE, 3-1,3-6 
ISIS-II 

error messages, D-lff. 

interrupt usage, 1-3 

memory usage, 1-3 

LIB, 4-1 ff. 
ADD command, 4-2 
CREATE command, 4-1 
DELETE command, 4-2 
error messages, G-lf. 
EXIT command, 4-3 
invocation, 4-1 
LIST command, 4-3 
PUBLICS control, 4-3 
librarian, see LIB 
libraries, 1-7 

as LINK input files, 2-1,2-3 
creating, modifying, listing see LIB 
library manager, see LIB 
LIB.TMP temporary file, 4-1 
LINES control (LOCATE), 3-7 

see also PURGE 
LINK,2-lff. 
error messages, E-lff. 
invocation, 2-3 f. 
MAP command, 2-4 
NAME command, 2-6 
overlays, use with 5-1 f. 
PRINT command, 2-6 
PUBLICS control, 2-3, 5-1 
LINK.TMP temporary file, 2-4 
LIST command (LIB), 4-3 

PUBLICS control, 4-3 
literature, related, iii 
LOAD system call, 3-5 
LOCATE 
error messages, F-lff. 
invocation, 3-1, 3-6 
LIB,4-lff. 
ADD, 4-2 
CREATE, 4-1 
DELETE, 4-2 
EXIT, 4-3 
LIST, 4-3 
LINK, 2-3ff. 
MAP, 2-4 
NAME, 2-6 
PRINT, 2-6 
PUBLICS, 2-3, 5-1 
LOCATE, 3-lff. 
CODE, 3-12 
COLUMNS, 3-6 
/common/, 3-14 
// (blank common), 3-14 
DATA, 3-13 
LINES, 3-7 
MAP, 3-8 
MEMORY, 3-13 
NAME, 3-9 
ORDER, 3-12 



PRINT, 3-9 

PUBLICS, 3-9 

PURGE, 3-10 

REST ARTO, 3-11 

STACK, 3-13 

STACKSIZE, 3-12 

START, 3-10 
LOCATE.TMP temporary file, 3-6 
LOW operator, 3-2f . 

MAP 

control in LINK, 2-4f . 

control in LOCATE, 3-8 
MEMORY 

control (LOCATE), 3-13 

in ORDER control (LOCATE), 3-12 

see also ORDER 
memory map, 1-6, 2-4f, 3-8 
memory segment, 1-4, 2-2 

length of, 3-8 

NAME 

control in LINK, 2-6 

control in LOCATE, 3-9 
named common, 3-14 

order produced by LINK, 3-3f . 
notation, syntax, iii 

OBJHEX, 6-2 

ORDER control (LOCATE), 3-12 

default order, 3-2 

specifying segment order, 3-3 
overlapping segments, 2-2, 2-5, 3-1, 3-8 
overlays, 5-1 ff. 

management, 5-2 

root segment, 5-1 

page-relocatable segments, 2-5 
paper-tape format (hexadecimal), A-l 
PRINT 

control in LINK, 2-6 

control in LOCATE, 3-9 
program segments 

assigning addresses to, 3-4, 3-12f . 

definition of , 1-4 

in LINK, 2-1 

in LOCATE, 3-2 

ordering, 3-2f, 3-12f. 
public symbols, 1-4, 2-3, 4-3, 5-1 
PUBLICS 

control in LIB, 4-3 

control in LINK, 2-3 

control in LOCATE, 3-9 

see also PURGE 
punctuation, in syntax notation, iv 
PURGE control (LOCATE), 3-10 

see also LINES, SYMBOLS, 
PUBLICS 
question mark (?) in module name, 
2-6, 3-9 

related literature, iii 
relative memory addresses, 1-1, l-4f. 
relative start address, of a segment, 1-4 
relocation types, 2-2 
how treated by LINK, 2-2f . 
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Index 



RENAME system call, 3-5 
RESTARTO control (LOCATE), 3-1 1 
reverse video, in syntax notation, iv 
root segment, 5-1 

satisfied module, 1-6 
STACK 

control (LOCATE), 3-13 

in ORDER control, 3-12 

see also ORDER 
stack segment, 1-4, 2-2 
STACKSIZE control (LOCATE), 3-12 
START control (LOCATE), 3-1 Of . 
SUBMIT files, effect on buffer 



requirements, 3-5 
SYMBOLS control (LOCATE), 3-10 

see also PURGE 
syntax notation, iiif . 
system calls (ISIS-II), 3-5 

temporary files 
LIB.TMP, 4-1 
LINK.TMP, 2-4 
LOCATE.TMP, 3-6 

unnamed (blank) common, 3-14 
unsatisfied external references, 1-6, 2-1 
unsatisfied modules, 1-6 
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